Validating a synchronization job
Under typical working conditions , if the Allow automatic deletion option is enabled in the synchronization job as described in Configuring synchronization options, the job will correctly detect and delete documents and tags from the repository that no longer exist in the source vault.
However, there are some situations when this cannot be reliably detected by the synchronization job, such as when the document or tag:
- Was never released
- Was purged
- Is not deleted in the vault but does fall outside the collection specified for synchronization
These situations can leave documents or tags in the repository that you might not want to remain. To clean up these deleted documents and tags, you should occasionally validate the synchronization job.
To validate a synchronization job:
- In Meridian Enterprise Server Administration Console, in the BC Publisher group, click Jobs. The Publish Jobs page appears and lists the existing jobs.
- On the ALL or EXPLORER SYNCHRONIZATION page, double-click the name of the job that you want to validate. The job's configuration option pages appear.
- In the app bar, click VALIDATE SYNCHRONIZATION. The CHECK dialog box appears.
- Click options or type values using the descriptions in the following table.
- Click OK to start the check. A background task is started and you can continue working. When the validation has completed, the VALIDATION REPORT dialog box appears and shows the information described in the following table.
- When you are finished viewing the report, click CLOSE.
Option | Description |
---|---|
Check for obsolete items |
Select one of the options to validate tags:
Note
When multiple synchronization jobs exist with the same source vault and any of them has the Only publish documents from the specified collection option set, any subsequent synchronization validation job will not mark any documents to be deleted. No documents will be marked to be deleted if the synchronization job does not have the Allow automatic deletion option enabled. |
Check for updated documents |
Select one of the options to validate documents:
|
Item | Description |
---|---|
Status |
The completion status of the validation. |
Report |
The quantities of objects found by the selected checks. |
Out of scope documents |
The number of documents in the source vault that are not in the collection specified for the synchronization job. |
Out of scope object tags |
The number of tags in the source vault that are not in the collection specified for the synchronization job. |
Missing items |
The sum of the documents and tags in the source vault that are not in the collection specified for the synchronization job. |
To schedule synchronization job validations:
- In Meridian Enterprise Server Administration Console, in the Repositories group, click Repositories. The Repositories page appears and lists the existing Meridian Explorer repositories and Meridian Enterprise vaults.
- Double-click the name of the repository that you want to configure. The Overview page for the repository appears.
- In the menu, click MANAGEMENT TOOLS. The management tools for the selected repository appear.
- In the VALIDATE SYNCHRONIZATION group, for the Run or schedule this task item, click SCHEDULE. The SCHEDULE dialog box appears. This dialog box requires the same input as the Windows Task Scheduler.
- Configure the scheduled task to run when you require and then click SCHEDULE.The task is modified and will run on the configured schedule.
- Scheduled validations will validate the synchronization jobs for all Meridian Enterprise source vaults of the current repository.
- By default, items will be updated or marked for deletion as necessary in the next synchronization job. This is the same as if both of the checking options described in the preceding task were set.
- Because this task can be quite time-consuming, we recommend that you schedule it to run only once per week outside of production hours.